Skip to main content

Setting up to update the VA Mobile doc site

These instructions are for people who are comfortable with maintaining and troubleshooting setup on their local machine. If that's not you, please reach out to the QART tech lead for assistance.

Before you can update the VA Mobile documentation website, you first need to download and set up a few different tools. You only need to do this once. Feel free to buddy up with someone for help with the initial setup!

1. Download & install Git

Instructions: Git - Installing Git

On Mac:

Open Terminal (It’s in Applications > Utilities; you can also use Spotlight to find it by pressing CMD + Spacebar on your keyboard and typing in the word “terminal.”

Terminal screenshot

To run Git, type git and then hit enter. If not installed, it will prompt you to install (hit “install”).

Installing Git in Terminal

If already installed, it will look like this:

Running Git in Terminal

On Windows:

Git - Downloading Package

2. Download & install a text editor

For example: Sublime Text or TextMate (You can do this while Git is downloading).

3. Download & install GitHub Desktop

a. Download GitHub Desktop

(You can also do this while Git is downloading).

b. Install GitHub Desktop

Open the ZIP file. When Finder comes up, you will want to drag the application into the Applications folder. (Not running GitHub Desktop from the Application folder could cause problems with the app.)

GitHub in Finder

Open the GitHub app from either the Finder window or using quick search ⌘ + Space and type “GitHub desktop”.

The first time you open the app, you may see a warning:

GitHub in Finder Warning

If so, click Open.

c. Set up GitHub Desktop

(You need to have Git installed to do this step). When the app opens it may ask you to log into GitHub. Once you are logged in you should see a screen like this:

GitHub - Let's Get Started

Wait until your repositories list loads on the right.

Get connected to the va-mobile-app repository

Once the list has loaded, scroll or use search until you find department-of-veterans-affairs/va-mobile-app. Click on the respiratory name (department-of-veterans-affairs/va-mobile-app). You should get an option to clone the repository (button at the bottom): https://github.com/department-of-veterans-affairs/va-mobile-app

Github - connect to repository

Cloning the va-mobile-app repository

Click the “Clone department-of-veterans-affairs/va-mobile-app” button. A modal will pop up (see below).

Github - clone repository

Choose the local path on your machine where you want to save it and click the “Clone” button (Documents is a good place, but anywhere but Desktop is a fine place to put it).

You will then see a loading screen:

Github - cloning repository

When the repository has finished cloning, your Github Desktop screen will look like this:

Github - no local changes

Your tools are now set up and ready for you to make changes to the Doc site!

4. Set up Docusaurus

The VA Mobile documentation website is built using Docusaurus 2, a modern static website generator. There are several steps you’ll need to take to get it set up. See also: Docusaurus Installation.

On Mac:

  1. Open Terminal. Download & install these things in the following order:
    1. Download & install home brew
    2. Download & install node and npm
    3. Download & install yarn

On Windows:

  1. Open Command Line. Download & install these things in the following order:
    1. Download & install node
    2. Download & install npm
    3. Download & install yarn

To set up Docusaurus, you will need to do two things.

First: Open the VAMobile folder in Terminal or Command Line.

  1. To do this, use the Finder to navigate to the folder where the doc site is on your machine: somefolderonyourcomputer/VAMobile

VA Mobile in Finder

  1. Back in Terminal/Command Line, type cd and then a space, then drag and drop the somefolderonyourcomuter/VAMobile/ folder from the finder into Terminal/Command Line. It will look like this:

Docusaurus in terminal - directory

  1. Hit enter. Type yarn and hit enter again.

Next: Navigate to the doc site repository folder in Terminal/Command Line.

  1. To do this, use the Finder to navigate to the folder where the doc site is on your machine: somefolderonyourcomputer/VAMobile/documentation

Doc site in Finder

  1. Back in Terminal/Command Line, type cd and then a space, then drag and drop the somefolderonyourcomputer/VAMobile/documentation folder from the finder into terminal. It will look like this:

Docusaurus in terminal - directory

  1. Hit enter. To install Docusaurus, type yarn and hit enter again.
  2. Docusaurus is now installed!